home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / misc / texsetup.zoo / texsetup.doc
Text File  |  1991-11-14  |  29KB  |  782 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.           So, This is Your First Time to Install TeX on an Atari ST!
  7.                (Instructions for installing and configuring TeX)
  8.  
  9.       Table of contents:
  10.  
  11.           Atari ST TeX experiences from the USENET . . . . . . .  1
  12.           Configuring the Plain ST TeX software 
  13.                 for the First Time . . . . . . . . . . . . . . .  2
  14.           The Font Conventions . . . . . . . . . . . . . . . . .  8
  15.           Using "dvieps" for EPSON 9-pin output  . . . . . . . . 10
  16.           Using "dviatari" for Screen Output . . . . . . . . . . 10
  17.           Using "showdvi" for Screen Output  . . . . . . . . . . 10
  18.           Using "dviprint" for EPSON 9-pin 
  19.                 or 24-pin Printers . . . . . . . . . . . . . . . 11
  20.           Getting 24-pin Fonts . . . . . . . . . . . . . . . . . 12
  21.           CS-TeX . . . . . . . . . . . . . . . . . . . . . . . . 12
  22.           Extra Help and Disclaimer  . . . . . . . . . . . . . . 12
  23.  
  24.  
  25.    Atari ST TeX experiences from the USENET
  26.    ========================================
  27.  
  28.        TeX (pronounced "teck", where the "X" is the greek character chi)
  29.    is a book and document formatting system that gives the user the absolute
  30.    best text formatting possible.  
  31.  
  32.        Normally TeX is found on mainframe or mini-computers in corporations
  33.    and educational organizations.  These versions of TeX are usually quite
  34.    large and robust.  The printing looks great, but you have to leave home
  35.    and visit your local computer center to view a good copy of a TeX'ed
  36.    document. 
  37.  
  38.        Fortunately, for those users that enjoy working on a personal
  39.    computers, TeX is available on virtually every popular micro-computer
  40.    available in the 1990's.  According to Bart Childs, former president of
  41.    the worldwide TeX Users' Group (TUG), the Commodore Amiga and the Atari
  42.    ST have some of the best versions of TeX available for any computer. 
  43.    This article is designed to give you a current set of instructions and
  44.    comments regarding the most popular versions of TeX for the Atari ST.
  45.  
  46.        The two popular flavors of TeX (as of November 1991) are:
  47.  
  48.             - regular TeX (the one that must be pieced together by
  49.                            the ST user)
  50.  
  51.             - CS-TeX (a set of diskettes containing a complete TeX document
  52.                            creation environment which fully installs
  53.                            itself.  Written by German Atari wizard 
  54.                            Christoff Strunk. )
  55.  
  56.    Each version has some advantages, but neither provide all of the
  57.    advantages.
  58.  
  59.        Regular TeX has the advantage of running well on computers
  60.    with a small amount of memory (1 Megabyte).  It interfaces well with
  61.    several tools for printing and viewing TeX files.  Its  disadvantage is
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. So, This is Your First Time to Install TeX on Your Atari ST!            Page 2
  70.  
  71.  
  72.    that it requires a lengthy manual installation.  A manual installation
  73.    will make the installer an expert on TeX installations, though.
  74.  
  75.        CS-TeX provides a full environment for creating a TeX document from
  76.    start to finish.  CS-TeX provides:
  77.  
  78.           - an editor,
  79.           - TeX,
  80.           - TeX format builder,
  81.           - two TeX file screen pre-viewers,
  82.           - Metafont,
  83.           - an Index builder,
  84.           - a bibliography tool,
  85.           - graphic file interfaces 
  86.           - and a simple graphical user interface
  87.  
  88.    The graphical user interface is optimized for people who don't like to
  89.    use a mouse, and the graphic file interfaces allow Pictures and graphs
  90.    created by other programs to be used in TeX documents.
  91.  
  92.  
  93.    Configuring the Plain ST TeX software for the first time
  94.    ========================================================
  95.  
  96.        Configuring the ST TeX software actually involves several
  97.        ordered steps.
  98.  
  99.            1) Obtaining the TeX software
  100.  
  101.            2) Creating a customized directory system
  102.  
  103.            3) Un-archiving the TeX software
  104.  
  105.            4) Setting up environment variables
  106.  
  107.            5) Creating the TeX "format" files.
  108.  
  109.    STEP DETAILS
  110.    ============
  111.  
  112.        >> 1. Obtaining the TeX software
  113.       
  114.              This step has a fairly broad scope, but one source for the
  115.              Plain TeX system is the Atari Archive ftp site at the 
  116.              University of Michigan in the United States.  Its ftp
  117.              name and internet number are:
  118.  
  119.                 atari.archive.umich.edu            141.211.164.8
  120.  
  121.              For the configuration instruction discussed in this document,
  122.              you should obtain the following files:
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. So, This is Your First Time to Install TeX on Your Atari ST!            Page 3
  136.  
  137.  
  138.              Directory: /atari/tex/tex31
  139.  
  140.                           size         date         name
  141.                        ======= ============ ============
  142.                         376570 Dec 31  1990 inputs.lzh
  143.                          26451 Aug 14 18:57 poofiles.zoo
  144.                         520881 Aug 14 18:50 texbin.zoo
  145.                         342243 Dec 14  1990 tfmfonts.lzh
  146.  
  147.              Directory: /atari/tex/dvi
  148.  
  149.                           size         date         name
  150.                        ======= ============ ============
  151.                          58562 May 18  1990 dviatari.zoo (S)
  152.                         239494 Apr 12  1989 dvieps.arc   (P)
  153.                         151658 Aug  6 12:07 shdvi10b.zoo (S,P)
  154.  
  155.  
  156.              Directory: /atari/tex/fonts
  157.  
  158.                           size         date         name
  159.                        ======= ============ ============
  160.                         365612 Sep  6  1989 dvifnts1.zoo
  161.                         471608 Sep  6  1989 dvifnts2.zoo
  162.                           1910 Sep  6  1989 dvifntsz.hlp
  163.                         208619 Sep 22  1989 showdvifonts.zoo
  164.  
  165.               Most of these files are required, but some of them provide
  166.               duplicate function.  The files in the "/atari/tex/dvi"
  167.               directory provide printing and pre-viewing functions.  If
  168.               you have the space, get them all.  
  169.  
  170.               - The "dviatari.zoo" archive contains "dviatari", a screen 
  171.                 pre-viewer that uses the "dvifnts*.*" archives in the 
  172.                 "/atari/tex/fonts" directory.
  173.  
  174.               - The "dvieps.arc" archive contains "dvieps" a program and 
  175.                 source code to print TeX's dvi-files to a 9-pin EPSON
  176.                 compatible printer.  "dvieps" also uses the "dvifnt*.*" 
  177.                 archives' font files.
  178.  
  179.               - The "shdvi10b.zoo" file contains "showdvi", a pre-viewer,
  180.                 and "dviprint", a dvi-file printing program.  "dviprint"
  181.                 will output to several types of printers including: 
  182.                 Epson 9-pin, Epson 24-pin, Atari SLM, and HP Laser-Jet
  183.                 printers.  Both programs can use the "dvifnts*.*" font 
  184.                 files.  In addition, the programs can use "flib", font 
  185.                 library, files, that are in the "showdvifonts.zoo" archive.
  186.                 
  187.              You need at least one (S) "Screen pre-viewer" and one (S) "Dvi 
  188.              file printer" archive.  For either of the sets of pre-view and 
  189.              print programs, you will need the "dvifnt*.*" files.  If you 
  190.              want to use the "flib" font library ability of the "shdvi10b.zoo"
  191.              programs, then you should get the "showdvifonts.zoo" file also.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. So, This is Your First Time to Install TeX on Your Atari ST!            Page 4
  202.  
  203.  
  204.        >> 2. Creating a customized directory system       
  205.  
  206.              This part requires you to think the hardest.  The following
  207.              directory names are a compromise of the directory names
  208.              used by usenet users who contributed to this article.
  209.              
  210.                  i. Select a base directory for your files.  I will use
  211.                     "D:\tex" for the base directory.  Edit this file (the
  212.                     one that your are currently reading) with a text editor
  213.                     and use the global search and replace function to change 
  214.                     "D:\tex" to the directory you want to use.
  215.                 
  216.                 ii. Create